home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 031a / zipapr13.zip / ZIPAPER.DOC < prev    next >
Text File  |  1991-10-29  |  24KB  |  543 lines
  1.        ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas     Page 1
  2.        ------------------------------------------------------------
  3.  
  4.  
  5. Warning
  6. -------
  7.  
  8. For people that don't like to read instructions (as well as everyone else),
  9. read this:
  10.  
  11. 1)  You really should read this entire file - at least up to the "Advanced
  12.     Options" section.
  13.  
  14. 2)  If you have a .BMP file called WALPAPER.BMP, YOU SHOULD RENAME IT!
  15.  
  16. IF YOU HAVE PROBLEMS:
  17. ---------------------
  18.  
  19. You can contact me on Compuserve at 72301,2164 and Prodigy at CWRF01A.
  20.  
  21. Telephone support:  You may call me.  I would prefer to talk on your dime
  22. <grin>.  If I don't answer when you call, and you want me to return it, I
  23. will return it collect unless you are a registered user.  Even so, I may ask
  24. you to call me right back if it's a long conversation.  After all, it's only
  25. a $10 program - if my phone bill exceeds the registration fee, well, you
  26. figure it out!  In any case, please keep the calls to a minimum.  Compuserve
  27. and Prodigy are the best ways to reach me, as I check in at least once a day
  28. (usually).  (714) 524-5625.  I am on Pacific Coast time, but I am around
  29. almost all the time (it's a home office).
  30.  
  31. To Print this documentation:
  32. ----------------------------
  33.  
  34. "TYPE ZIPAPER.DOC >LPT1:"
  35.  
  36.  
  37.                            _______
  38.                       ____|__     |                (R)
  39.                    --|       |    |-------------------
  40.                      |   ____|__  |  Association of
  41.                      |  |       |_|  Shareware
  42.                      |__|   o   |    Professionals
  43.                    -----|   |   |---------------------
  44.                         |___|___|    MEMBER
  45.  
  46.  
  47.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 2
  48.         ------------------------------------------------------------
  49.  
  50. ###########################################################################
  51.                   Users of ZiPaper version 1.2, 1.2a:
  52. ###########################################################################
  53.  
  54. Installing the new version:
  55. ---------------------------
  56. Replace the ZIPAPER.EXE file by the new ZIPAPER.EXE.
  57.  
  58. ###########################################################################
  59.                   Users of ZiPaper version 1.1:
  60. ###########################################################################
  61.  
  62. Installing the new version:
  63. ---------------------------
  64. 1) Replace the ZIPAPER.EXE file for version 1.1 by the new ZIPAPER.EXE.
  65.  
  66. 2) Rename the file ZIPAPER.DAT that is in the same directory as your wallpaper
  67.    ZIP file, as in this example:
  68.  
  69.       Assume your .ZIP file is called MYPAPER.ZIP
  70.       You would type at the DOS prompt: RENAME ZIPAPER.DAT MYPAPER.ZPA
  71.  
  72. 3) Since the wallpaper file is now extracted into the \WINDOWS directory,
  73.    make sure that ZiPaper is run from that directory.
  74.  
  75. 4) You may need to change the WIN.INI file to look for the file WALPAPER.BMP
  76.    in the Windows directory.  The easiest way to do this is to run the new
  77.    version of ZiPaper, then run Windows.  Click on Control Panel, then Desktop.
  78.    Click on the down-arrow next to the wallpaper file name, and select the file
  79.    WALPAPER.BMP from the list.  Click on OK and you're done!
  80.  
  81. Registration:
  82. -------------
  83.  
  84. If you have already sent in your $10 to register version 1.0 or later, you do
  85. not need to register version 1.3.  If you haven't registered, please do (see
  86. below).
  87.  
  88. ###########################################################################
  89.                   Users of ZiPaper version 1.0:
  90. ###########################################################################
  91.  
  92. Installing the new version:
  93. ---------------------------
  94.  
  95. Replace the ZIPAPER.EXE file for version 1.0 by the new ZIPAPER.EXE.
  96.  
  97. Delete the file ZIPAPER.DAT that is in the same directory as your wallpaper
  98. ZIP file.  If you don't delete this file, you WILL get unexpected results or
  99. errors.
  100.  
  101. Registration:
  102. -------------
  103.  
  104. If you have already sent in your $10 to register version 1.0 or 1.1, you do not
  105. need to register version 1.2.  If you haven't registered, please do (see below).
  106.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 3
  107.         ------------------------------------------------------------
  108.  
  109. ###########################################################################
  110.                            Introduction:
  111. ###########################################################################
  112.  
  113. ZiPaper (that's "Zip Paper") is a program that chooses one of your .BMP files
  114. for use as Windows Wallpaper.  There are several programs out that do that,
  115. though.  ZiPaper is different - it lets you place all your .BMP Wallpaper
  116. files in a .ZIP file (or LHArc .LZH file), reducing disk space dramatically.
  117.  
  118. Features (arranged by version number):
  119. --------------------------------------
  120. 1.0
  121. Using PKZIP, you place your Windows .BMP wallpaper files into a ZIP file.
  122. ZiPaper reads the ZIP file, and extracts one at random.
  123.  
  124. Because ZiPaper keeps track of each file it has extracted, you are guaranteed to
  125. get an even selection of files (some wallpaper selection programs have a nasty
  126. habit of selecting the same files over and over again).
  127.  
  128. 1.1
  129. You may specify "Tiled" or "Centered" for each wallpaper file in the ZIP file.
  130.  
  131. You can temporarily "disable" individual wallpaper files, so that ZiPaper won't
  132. extract them.  You can still keep them in the ZIP file, though.
  133.  
  134. You can group your files into any of 4 groups, with Tile/Center and Enable/
  135. Disable specified differently in each group.  This allows you to group "after
  136. hours" wallpaper files separately from other files, group 16 color and 256 color
  137. files separately, etc.
  138.  
  139. 1.2
  140. You may specify a startup option, /F, that allows you to manually select which
  141. wallpaper file you want extracted (you select from a list).  Have you ever
  142. wanted to show someone your Windows setup, and wanted a specific wallpaper?
  143. Now you can.
  144.  
  145. A similar option, /F?, asks you if you want to manually select a wallpaper file
  146. or not.  It waits for an answer for 3 seconds - if you don't answer Y then it
  147. randomly selects a wallpaper file for you.
  148.  
  149. You can force ZiPaper to extract a specific wallpaper file by using the
  150. /F=filename.bmp option.
  151.  
  152. You may now use multiple ZIP files, and keep them in the same directory (if you
  153. wish).  The .DAT file that is created is now named similar to the ZIP file name.
  154.  
  155. The Wallpaper file is now extracted into the Windows directory, to simplify the
  156. task of using multiple ZIP files on different drives or directories.
  157.  
  158. 1.2a
  159. Added the /NR option (No Random).  Using this option will cause ZiPaper to
  160. extract each file in the order the file appears in the ZIP file.  You can
  161. set up the order in any way you like.
  162.  
  163. 1.3
  164. Added support for LHArc.  Use the /LHA option.
  165.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 4
  166.         ------------------------------------------------------------
  167.  
  168. ###########################################################################
  169.                            Installation:
  170. ###########################################################################
  171.  
  172. Requirements for running ZiPaper
  173. --------------------------------
  174.  
  175. ZiPaper is a DOS program, and therefore does not require Windows.  However,
  176. it is designed to select Windows .BMP files for use as Wallpaper, so if you
  177. don't have Windows, you don't need this program!
  178.  
  179. You need PKUNZIP.EXE from  PKWARE, Inc.
  180.                            7545 N. Port Washington Rd.
  181.                            Glendale, WI 53217
  182.                            (414) 352-3670
  183.  
  184. It is available on many BBSes as Shareware.  You'll also need PKZIP.EXE to
  185. create the ZIP file.
  186.  
  187. If you prefer, you may use LHArc.  It is available on many BBSes, as well as
  188. from Shareware Vendors.
  189.  
  190.  
  191. Quick Tour:
  192. -----------
  193.  
  194. You run ZiPaper each time BEFORE you start Windows.
  195.  
  196. You tell ZiPaper the name of your ZIP or LZH file that contains .BMP files for
  197. use as wallpaper.  It will extract a .BMP file randomly into the Windows 
  198. directory, and change its name to WALPAPER.BMP.
  199.  
  200. You make a one-time change to Windows, telling it to use the file
  201. WALPAPER.BMP as wallpaper.
  202.  
  203. That's it!  (Aside from the advanced options, which will be discussed later.)
  204.  
  205. Installation/Running
  206. --------------------
  207.  
  208. Move all the .BMP files you want to use as wallpaper into a ZIP file.  See
  209. PKZIP's or LHArc's instructions for this.  Place the ZIP or LZH file in the 
  210. Windows directory, or anywhere else you wish.
  211.  
  212. Place the file ZIPAPER.EXE in any directory on your path (actually, if you
  213. specify the path when you run the program, you can place ZiPaper anywhere on
  214. your hard disk).
  215.  
  216. Since ZiPaper should be run each time BEFORE you run Windows, I suggest you
  217. place the line that runs ZiPaper into your AUTOEXEC.BAT file, or a batch file
  218. that you use to run Windows.  DO NOT run ZiPaper from the Load= or Run= line
  219. of your WIN.INI file.  Doing so will produce unpredictable results.
  220.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 5
  221.         ------------------------------------------------------------
  222.  
  223. Here's the syntax for running ZiPaper (anything enclosed in brackets [] is
  224. optional):
  225.  
  226.    ZiPaper [d:\path\]walpaper.zip [[d:\path\]pkunzip.exe] [advanced options]
  227.     -or-
  228.    ZiPaper [d:\path\]walpaper.lzh [[d:\path\]lha.exe] /LHA [advanced options]
  229.  
  230.    "d:\path\walpaper.zip" is the drive, path, and file name of the ZIP file
  231.     that contains your .BMP files.  If you are using LHArc, then specify the
  232.     name of the .LZH file here.
  233.  
  234.    "d:\path\pkunzip.exe" (optional) is the drive, path, and file name of
  235.     PKUNZIP.EXE.  You don't need to specify this if PKUNZIP.EXE is located
  236.     along your current path.
  237.  
  238.    If you are using LHArc, then you MUST specify the /LHA option.  ZiPaper
  239.    will expect the program to be called LHA.EXE, but you can specify the
  240.    actual program name - see above.
  241.  
  242.    "advanced options" will be explained later.
  243.  
  244. Run Windows, click on Control Panel, Desktop.  In the box titled "Wallpaper",
  245. click in the box that is labeled "File".  Delete what is in there (if
  246. anything) and type in the name "WALPAPER.BMP".  If you have *any* Wallpaper
  247. that you would like Centered, please read the section on Tiled/Centered
  248. Wallpaper, below.  For now, click on "Tile".
  249.  
  250. Click on OK and you're done.
  251.  
  252. Tiled/Centered Wallpaper:
  253. -------------------------
  254.  
  255. If you have wallpaper files that don't fill the screen, you have 2 options.
  256. The first is to "tile" it.  This causes Windows to duplicate the wallpaper
  257. file across your screen until the screen is full.  The second option is to
  258. "center" it, which causes Windows to center the wallpaper on your screen.
  259. Neither of these options has any affect on wallpaper that fills the entire
  260. screen.
  261.  
  262. If all your small wallpaper files are either "tiled" or "centered", then set
  263. the option in the Desktop section of Control Panel accordingly.  If not, see
  264. the section on Advanced Options, which will explain how to select "tile" or
  265. "center" for each file.
  266.  
  267.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 6
  268.         ------------------------------------------------------------
  269.  
  270. ###########################################################################
  271.                            Advanced Options:
  272. ###########################################################################
  273.  
  274. NOTE: ZiPaper can function just fine without using these advanced options.
  275.       They are available to enhance ZiPaper's operation, but you certainly
  276.       don't have to use them.
  277.  
  278. ZiPaper creates a data file for each ZIP or LZH file you use.  The file is 
  279. named the same as the ZIP or LZH file, except it has the extension ZPA.  This
  280. file stores information about each wallpaper that is in the ZIP or LZH file.
  281. (Don't worry if you add or remove wallpaper files from the ZIP or LZH file
  282. - ZiPaper will adjust its file accordingly.)
  283.  
  284. Setup Screen:
  285. -------------
  286.  
  287. If you wish, you may run ZiPaper with the /S option, and ZiPaper will bring
  288. up a setup screen that allows you to tell ZiPaper a few things about each
  289. wallpaper file.
  290.  
  291.    ZiPaper [d:\path\]walpaper.zip [[d:\path\]pkunzip.exe] /S
  292.     -or-
  293.    ZiPaper [d:\path\]walpaper.lzh [[d:\path\]lha.exe] /LHA /S
  294.    
  295.  
  296. Here are the things you can tell ZiPaper about each wallpaper:
  297.  
  298.    1) Whether to Tile or Center it.  You may also set it to "Default" (which
  299.       is what they are all initialized to at the start).  "Default" means
  300.       that they will be Tiled or Centered, depending on what you specify the
  301.       default as (at run time - explained below).
  302.  
  303.    2) Whether to temporarily ignore (disable) it.
  304.  
  305. Four Option Groups:
  306. -------------------
  307.  
  308. Here's where it gets a little tricky.  You can specify the above options UP
  309. TO 4 TIMES for each wallpaper.  Why would you want to do that?  Here's a
  310. couple of scenarios (they're simple; you can devise more complex ones):
  311.  
  312.    1) You run Windows in 640x480 mode and 800x600 mode.  You have some
  313.       wallpaper files that you want centered in 640x480, and tiled in
  314.       800x600.  You set one set of options to specify "Centered", and another
  315.       "Tiled".
  316.  
  317.    2) You have some wallpaper files that are not appropriate during working
  318.       hours, but you want to use them after-hours.  You set one set of
  319.       options to "Disable" certain wallpaper files, and you use this option
  320.       during working hours.  You set another other to "Enabled", and you use
  321.       it after hours.
  322.  
  323. Run ZiPaper with the /S option, and look at the screen.  It is pretty self-
  324. explanatory, once you understand the "4 option groups".
  325.  
  326.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 7
  327.         ------------------------------------------------------------
  328.  
  329. Using the screen:
  330. -----------------
  331.  
  332. Use the Tab key and the arrow keys to move around the screen.  Page Up and
  333. Page Down allow you to scroll through all your files (if you have more than
  334. will fit on one screen).
  335.  
  336. Change an option by typing the first letter.
  337.  
  338. Press Escape when done.  ZiPaper will ask you if you want to save the options
  339. you just changed.
  340.  
  341. ###########################################################################
  342.                  Running with the Advanced Options:
  343. ###########################################################################
  344.  
  345. ZiPaper [d:\path\]walpaper.zip [d:\path\pkunzip.exe] [/W [/T|/C]] [/1../4]
  346.  -or-
  347. ZiPaper [d:\path\]walpaper.lzh [d:\path\lha.exe] /LHA [/W [/T|/C]] [/1../4]
  348.  
  349.  
  350. /W  This option means "Update the WIN.INI file", and is used when you want
  351.     ZiPaper to look at the Tile/Center options you specified on the Setup
  352.     Screen (see above).  ZiPaper will change the Tile/Center option
  353.     accordingly.  ZiPaper saves the old version of WIN.INI as WININI.BAK.
  354.     NOTE: the Windows directory must be the current directory in order for
  355.     ZiPaper to find the WIN.INI file.
  356.  
  357. /T or /C  If you set up the Tile/Center option for a file to be "Default",
  358.     this option tells ZiPaper what the "default" is (/T for Tiled, /C for
  359.     Centered).  If you don't specify either, ZiPaper will assume Tiled.
  360.  
  361. /1../4  Specifying /1, /2, /3, or /4 tells ZiPaper which set of options to
  362.     use (see Setup Screen, above).  If you don't specify one of these, then
  363.     /1 is assumed.
  364.  
  365. Examples:
  366. ---------
  367.  
  368. ZIPAPER D:\GRAPHICS\WALPAPER.ZIP /W
  369.  
  370.   This runs ZiPaper, extracts a wallpaper (based on the first set of
  371.   options), and updates the WIN.INI file for Tile/Center.
  372.  
  373. ZIPAPER D:\GRAPHICS\WALPAPER.ZIP /W /C /2
  374.  
  375.   This runs ZiPaper, extracts a wallpaper (based on the second set of
  376.   options).  If the file's Tile/Center option is "Default", it will be
  377.   centered.  ZiPaper updates the WIN.INI file for Tile/Center.
  378.  
  379.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 8
  380.         ------------------------------------------------------------
  381.  
  382. ###########################################################################
  383.                           Other Options
  384. ###########################################################################
  385.  
  386. Sometimes, you want a particular wallpaper file.  Perhaps you are going to show
  387. off your Windows setup, and you have a really eye-catching wallpaper.  A new
  388. option (with 3 variations) has been added to facilitate this:
  389.  
  390.    ZiPaper [d:\path\]walpaper.zip [[d:\path\]pkunzip.exe] /F
  391.                                                           /F?
  392.                                                           /F=filename.bmp
  393.  
  394. /F  This option will run ZiPaper just like the /S option does (see above).  It
  395.     brings up the setup screen, and lets you chose which wallpaper file you
  396.     want ZiPaper to extract.  Just hilight the file you want, and press F10.
  397.  
  398. /F? This option is just like the above /F option, except that it asks you if
  399.     you want to select a file manually.  You have 3 seconds in which to respond
  400.     Y.  If you type a Y, then the setup screen is brought up, and you can
  401.     select a file.  If you answer N, or the 3 seconds passes by, ZiPaper acts
  402.     as though the /F option had never been specified: it extracts a wallpaper
  403.     file randomly.
  404.  
  405.     If you find yourself using the /F option frequently, run ZiPaper with the
  406.     /F? option ALL THE TIME.
  407.  
  408. /F=filename.bmp
  409.     This option allows you to force ZiPaper to extract the specified wallpaper
  410.     file.  You might use this option with a special batch file for those times
  411.     that you know you will want this wallpaper file.
  412.  
  413. /NR
  414.     This option ("No Random") causes ZiPaper to extract wallpaper files in the
  415.     order they appear in the ZIP file.  This allows YOU to choose the order you
  416.     will see the wallpaper files.
  417.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas    Page 9
  418.         ------------------------------------------------------------
  419.  
  420. ###########################################################################
  421.                           Life with ZiPaper:
  422. ###########################################################################
  423.  
  424. Once you've done the installation steps, you need never bother with ZiPaper
  425. again (except to use the Advanced Options, or maybe to send in a shareware
  426. fee <grin>).  You may add and remove .BMP files from your ZIP or LZH file 
  427. with no fear of upsetting ZiPaper.
  428.  
  429. ZiPaper creates a file with the same name as your ZIP or LZH file, but with 
  430. the extension .ZPA (in the directory that contains your ZIP or LZH file).  
  431. This file keeps track of what .BMP files it has chosen, so that you get a more 
  432. even distribution of Wallpaper choices.  It also holds your advanced options 
  433. setup.  If you have any problems, you may delete this file. It will be re-
  434. created the next time ZiPaper is run.  (Remember, though, that if you delete 
  435. it, you will have to set up your Advanced Options again, if you use them.)
  436.  
  437. How to Pay for/Register ZiPaper
  438. -------------------------------
  439.  
  440. If you find you like ZiPaper, please send $10 cash or check (US bank) to:
  441.  
  442.   Daniel Thomas
  443.   2301 North Huron Circle
  444.   Placentia, CA  92670
  445.  
  446. I didn't make ZiPaper "nagware".  It doesn't bug you with a pop-up screen asking
  447. for money.  All the same, please remember that this program is the result of
  448. much hard work and time spent on Compuserve, and all registrations help.  If you
  449. think $10 is too much for this program, then send less.  Every little bit helps.
  450.  
  451. You may reach me on Compuserve at: 72301,2164  or Prodigy at CWRF01A.
  452.  
  453. Enjoy!
  454.  
  455. Dan Thomas
  456.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas   Page 10
  457.         ------------------------------------------------------------
  458.  
  459. ###########################################################################
  460.                  The Association of Shareware Professionals 
  461. ###########################################################################
  462.  
  463. ASP Ombudsman Information 
  464.  
  465. This program is produced by a member of the Association of Shareware
  466. Professionals (ASP).  ASP wants to make sure that the shareware principle works
  467. for you. If you are unable to resolve a shareware-related problem with an ASP
  468. member by contacting the member directly, ASP may be able to help. The ASP
  469. Ombudsman can help you resolve a dispute or problem with an ASP member, but
  470. does not provide technical support for members' products.  Please write to the
  471. ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe
  472. message via CompuServe Mail to ASP Ombudsman 70007,3536. 
  473.  
  474.  
  475. ASP POLICY ON NO CRIPPLING 
  476.  
  477. The principle behind shareware is "try before you buy."  ASP believes that
  478. users have a right to try a fully functioning shareware program in their
  479. regular computing environment.  Accordingly, ASP authors agree that: 
  480.  
  481. (1) The executable files (and/or items linked in with executables) in their
  482. shareware and registered versions will be the same (with the exceptions noted
  483. below) 
  484.  
  485. (2) All the program's features will be fully documented. 
  486.  
  487. (3) Registration encouragement procedures which in the judgment of the Board 
  488. are either unreasonable or unprofessional are not allowed. 
  489.  
  490. Registration Reminder Screens should (if used): 
  491.  
  492. 1) be displayed no more than twice each time the program runs (or twice per day
  493. for long-running programs such as TSR's). 
  494.  
  495. 2) not require more than two keystrokes to bypass. 
  496.  
  497. 3) not have a forced minimum display time of more than three seconds.  In other
  498. words, the RRS itself should not take control of the computer away from the user
  499. for more than  three seconds. 
  500.  
  501. Practices such as creating undocumented hidden files or printing a registration
  502. form without the user's knowledge or consent are prohibited.  It is NOT
  503. necessary to have any of the above as a simple "Strike Any Key To Continue" is
  504. the least objectionable to the user. 
  505.         ZiPaper version 1.3 Copyright (c) 1990,1991 by Daniel Thomas   Page 11
  506.         ------------------------------------------------------------
  507.  
  508. Exceptions to a strict interpretation of this policy are as follows: 
  509.  
  510.     to save disk space, tutorial and additional explanatory material may be
  511.     left out of the shareware documentation. 
  512.  
  513.     the shareware version may have registration encouragement procedures absent
  514.     from the registered version (or which can be disabled with a code only
  515.     provided to registered users). 
  516.  
  517.     the registered version may include sample files not included in the
  518.     shareware version. 
  519.  
  520.     if source code is offered with the registered version, it may be withheld
  521.     from the shareware version. 
  522.  
  523.     the author may provide two shareware versions: one a small version which
  524.     the author designates the distributed version in normal circumstances (e.g.
  525.     language tools in C only available in one model) so long as the full
  526.     shareware version is available from some public source (possibly for a
  527.     small distribution fee) and may be copied for trial purposes.  The small
  528.     version's documentation must clearly describe how users may obtain the full
  529.     shareware version. 
  530.  
  531.     the author may provide an enhanced retail version of the program so long as
  532.     it is not (in the opinion of 60% of the BoD) merely an attempt to circumvent
  533.     this no crippling policy 
  534.  
  535.     registered users may be provided bonus utilities unrelated to (and which do
  536.     not change) the basic functionality of the program 
  537.  
  538.     registered users may be given utilities which provide a convenience but
  539.     which are not essential 
  540.  
  541.     exceptions approved by the ASP board of directors by a 60% vote of those
  542.     voting 
  543.